home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmObjectAtPoint.z / XmObjectAtPoint
Encoding:
Text File  |  2001-04-17  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt - A toolkit function that determines which
  10.           child intersects or comes closest to a specified point
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           WWWWiiiiddddggggeeeetttt XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           PPPPoooossssiiiittttiiiioooonnnn xxxx,
  17.           PPPPoooossssiiiittttiiiioooonnnn yyyy);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt searches the child list of the specified
  24.           manager _w_i_d_g_e_t and returns the child most closely associated
  25.           with the specified _x,_y coordinate pair.
  26.  
  27.           For the typical Motif manager _w_i_d_g_e_t, XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnnttttuses
  28.           the following rules to determine the returned object:
  29.  
  30.              +o  If one child intersects _x,_y, XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnnttttreturns
  31.                 the widget ID of that child.
  32.  
  33.              +o  If more than one child intersects _x,_y, XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt
  34.                 returns the widget ID of the visible child.
  35.  
  36.              +o  If no child intersects _x,_y, XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnnttttreturns
  37.                 NULL.
  38.  
  39.           The preceding rules are only general. In fact, each manager
  40.           _w_i_d_g_e_t is free to define "most closely associated" as it
  41.           desires.  For example, if no child intersects _x,_y, a manager
  42.           might return the child closest to _x,_y.
  43.  
  44.           _w_i_d_g_e_t    Specifies a manager widget.
  45.  
  46.           _x         Specifies the x-coordinate about which you are
  47.                     seeking child information. The x-coordinate must
  48.                     be specified in pixels, relative to the left side
  49.                     of _m_a_n_a_g_e_r.
  50.  
  51.           _y         Specifies the y-coordinate about which you are
  52.                     seeking child information. The y-coordinate must
  53.                     be specified in pixels, relative to the top side
  54.                     of _m_a_n_a_g_e_r.
  55.  
  56.      RRRREEEETTTTUUUURRRRNNNN
  57.           Returns the child of _m_a_n_a_g_e_r most closely associated with
  58.           _x,_y.  If none of its children are sufficiently associated
  59.           with _x,_y, returns NULL.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmOOOObbbbjjjjeeeeccccttttAAAAttttPPPPooooiiiinnnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEELLLLAAAATTTTEEEEDDDD
  75.           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3).
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.